﻿// ------------------------------------------------------------------------
// 项目名称：Canroc.Net 
// 版权归属：Canroc（https://gitee.com/canroc）
//
// 许可证信息
// Canroc.Net项目主要遵循 Apache 许可证（版本 2.0）进行分发和使用。许可证位于源代码树根目录中的 LICENSE-APACHE 文件。
//
// 使用条款：
// 1.使用本项目应遵守相关法律法规和许可证的要求。
// 2.不得利用本项目从事危害国家安全、扰乱社会秩序、侵犯他人合法权益等法律法规禁止的活动。
// 3.任何基于本项目二次开发而产生的一切法律纠纷和责任，我们不承担任何责任
//
// 免责声明
// 对于因使用本代码而产生的任何直接、间接、偶然、特殊或后果性损害，我们不承担任何责任。
//
// 其他重要信息
// Canroc.Net 项目的版权、商标、专利和其他相关权利均受相应法律法规的保护。
// ------------------------------------------------------------------------

using Canroc.Net.RemoteHttp.WeChat.Dto;

namespace Canroc.Net.RemoteHttp.WeChat;

/// <summary>
///     微信开放接口
/// </summary>
[HttpClientName("wechat")]
public interface IWeChatRemoteHttp : ICanrocRemoteHttpBase
{
    #region 公共

    /// <summary>
    ///     微信 access_token
    /// </summary>
    [Get("/cgi-bin/token?grant_type=client_credential&appid={appid}&secret={secret}")]
    Task<HttpRemoteResult<WeChatOpenApiAccessTokenOutput>> GetAccessTokenAsync(string appid, string secret);

    #endregion

    #region 微信公众号

    /// <summary>
    ///     通过code换取网页授权access_token
    /// </summary>
    /// <param name="appid"></param>
    /// <param name="secret"></param>
    /// <param name="code"></param>
    /// <returns>access_token</returns>
    [Post("/sns/oauth2/access_token?appid={appid}&secret={secret}&code={code}&grant_type=authorization_code")]
    Task<HttpRemoteResult<WeChatOpenApiLoginOutput>> OfficialLoginAsync(string appid, string secret, string code);

    /// <summary>
    ///     拉取用户信息(需scope为 snsapi_userinfo)
    /// </summary>
    /// <param name="accessToken"></param>
    /// <param name="openid"></param>
    /// <returns></returns>
    [Post("/sns/userinfo?access_token={accessToken}&openid={openid}&lang=zh_CN")]
    Task<HttpRemoteResult<WeChatOpenApiUserInfoOutput>> OfficialGetUserinfoAsync(string accessToken, string openid);

    /// <summary>
    ///     推送模版消息
    /// </summary>
    [Post("/cgi-bin/message/template/send?access_token={token}")]
    Task<HttpRemoteResult<WeChatOpenApiSendTemplateOutput>> OfficialSendNoticeAsync(string token,
        [Body] WeChatOpenApiSendTemplateInput noice);

    #endregion
}